---
title: Migrando um projeto existente para o Astro
description: Algumas dicas e truques para converter seu site para o Astro.
i18nReady: true
---
import MigrationGuidesNav from '~/components/MigrationGuidesNav.astro';

**Pronto para converter seu site para o Astro?** Veja um dos nossos guias para dicas de migração.

## Guias de Migração

<MigrationGuidesNav />

Note que várias dessas páginas são **esboços**: elas são coleções de recursos esperando por sua contribuição!

## Por que migrar seu site para o Astro?

Astro tem vários benefícios: performance, simplicidade e muitas das funcionalidades que você quer integradas ao framework. Quando você precisa expandir seu site, Astro providencia várias [integrações oficiais e de terceiros da comunidade](https://astro.build/integrations).

Migrar pode ser menos trabalhoso do que você acredita!

Dependendo do seu projeto existente, você pode ser capaz de usar os já existentes:

- [Componentes de frameworks de UI](/pt-br/guides/framework-components/) diretamente no Astro. 

- [Folhas de estilo ou bibliotecas de CSS](/pt-br/guides/styling/) incluindo Tailwind.

- [Arquivos Markdown/MDX](/pt-br/guides/markdown-content/), configurados usando seus [plugins remark e rehype](/pt-br/guides/markdown-content/#configurando-markdown-e-mdx).

- [Conteúdos de CMS](/pt-br/guides/cms/) a partir de uma integração ou API.


## Quais projetos posso converter para o Astro?

[Vários sites existentes podem ser construídos com Astro](/pt-br/concepts/why-astro/). Astro é especialmente adequado para seus sites baseados em conteúdo como blogs, páginas iniciais, sites de marketing e portfólios. Astro se integra com vários CMSs headless populares e te permite conectar carrinhos de compras de eCommerce.

Astro te permite escolher entre um site gerado estaticamente e [renderização no lado do servidor (SSR)](/pt-br/guides/server-side-rendering/), o fazendo um ótimo substituto para SSGs ou para sites que precisam buscar dados da página no momento.

## Como o design do meu projeto vai mudar?

Dependendo do seu projeto existente, você pode precisar pensar de forma diferente sobre:

- Projetar com [Ilhas Astro](/pt-br/concepts/islands/#o-que-é-uma-ilha) para evitar enviar JavaScript desnecessário ao navegador.

- Providenciar interatividade no lado do cliente com [tags `<script>` no lado do cliente](/pt-br/guides/client-side-scripts/) ou [componentes de frameworks de UI](/pt-br/guides/framework-components/).

- Gerenciar [estado compartilhado](/pt-br/recipes/sharing-state-islands/) com Nano Stores ou armazenamento local ao invés de hooks ou wrappers a nível de aplicação.

